home *** CD-ROM | disk | FTP | other *** search
/ NOVA - For the NeXT Workstation / NOVA - For the NeXT Workstation.iso / Apps / AudioApps / CSound.app / manual / m2.port < prev    next >
Encoding:
Text File  |  1992-12-21  |  3.0 KB  |  68 lines
  1. .nf
  2.     kr    \fBport\fR    ksig, ihtim[, isig]
  3.     ar    \fBtone\fR    asig, khp[, istor]
  4.     ar    \fBatone\fR    asig, khp[, istor]
  5.     ar    \fBreson\fR    asig, kcf, kbw, kscl[, istor]
  6.     ar    \fBareson\fR    asig, kcf, kbw, kscl[, istor]
  7. .fi
  8.  
  9. A control or audio signal is modified by a low- or band-pass recursive filter
  10. with variable frequency response.
  11.  
  12.  
  13. INITIALIZATION
  14.  
  15. \fIisig\fR - initial (i.e. previous) value for internal feedback.
  16. The default value is 0.
  17.  
  18. \fIistor\fR - initial disposition of internal data space.  Since filtering
  19. incorporates a feedback loop of previous output, the initial status of the
  20. storage space used is significant.  A zero value will clear the space; a
  21. non-zero value will allow previous information to remain.  The default
  22. value is 0.
  23.  
  24.  
  25. PERFORMANCE
  26.  
  27. \fBport\fR applies portamento to a step-valued control signal.  At each
  28. new step value, \fIksig\fR is low-pass filtered to move towards
  29. that value at a rate determined by \fIihtim.
  30. ihtim\fR is the "half-time" of the function (in seconds),
  31. during which the curve will traverse half the distance towards the 
  32. new value, then half as much again, etc., theoretically never reaching
  33. its asymptote.
  34.  
  35. \fBtone\fR implements a first-order recursive low-pass filter in which the
  36. variable \fIkhp\fR (in c.p.s.) determines the response curve's half-power
  37. point.  Half power is defined as peak power / root 2.
  38.  
  39. \fBreson\fR is a second-order filter in which \fIkcf\fR controls the center
  40. frequency, or cps position of the peak response, and \fIkbw\fR controls its
  41. bandwidth (the cps difference between the upper and lower half-power
  42. points).  The input \fIkscl\fR acts as a coded scaling factor: a value of 1
  43. signifies a peak response factor of 1, i.e.  all frequencies other than
  44. \fIkcf\fR are attenuated in accordance with the (normalized) response
  45. curve.  A value of 2 raises the response factor so that its overall RMS
  46. value equals 1.  (This intended equalization of input and ouput power
  47. assumes all frequencies are physically present; hence it is most applicable
  48. to white noise.) A zero value signifies no scaling of the signal, leaving
  49. that to the user.
  50.  
  51. \fBatone, areson\fR are filters whose transfer functions are the
  52. complements of \fBtone\fR and \fBreson\fR.  \fBatone\fR is thus a form of
  53. high-pass filter and \fBareson\fR a notch filter whose transfer functions
  54. represent the "filtered out" apsects of their complements.  Note, however,
  55. that power scaling is not normalized in \fBatone, areson\fR, but remains
  56. the true complement of the corresponding unit.  Thus an audio signal,
  57. filtered by parallel matching \fBreson\fR and \fBareson\fR units, would
  58. under addition simply reconstruct the original spectrum.  This property is
  59. particularly useful for controlled mixing of different sources (e.g., see
  60. \fBlpreson\fR).
  61.  
  62. Complex response curves such as those with multiple peaks can be obtained
  63. by using a bank of suitable filters in series.  (The resultant response is
  64. the product of the component responses.)  In such cases, the combined
  65. attenuation may result in a serious loss of signal power, but this can be
  66. regained by the use of \fBbalance\fR.
  67. .bp
  68.